home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / pkxtra.arc / PKXTRACT.DOC next >
Text File  |  1988-01-13  |  10KB  |  266 lines
  1.  
  2.         PKXTract.EXE Version 1.0                          12 January 1988 
  3.         Copyright (C) 1988                                    Chris Brown
  4.  
  5.         This program is an enhancement to PKWARE's PKarc and PKXarc  file
  6.         archiving programs.  The purpose of this program is to provide an
  7.         easy  way  to  select and extract files of  different  names  and
  8.         extensions  from ARC files in one easy step.  This is  especially
  9.         useful if you have a large ARC file and only want a few different
  10.         files  or can't remember the name(s) of the file(s) that  you  do
  11.         want.  It also provides a convenient way to view an ARC file.
  12.  
  13.         As the program is written right now, it has to be run from a hard
  14.         disk.  It looks for the file COMMAND.COM which is found on a hard
  15.         disk (well, most anyway) in the root directory of drive C: (C:\).
  16.         If  it can't find it, your system may lock up (at worst)  or  the
  17.         program  will  simply  stop running and give you  a  nasty  error
  18.         message (99 times out of 100 anyway).  Once it finds COMMAND.COM,
  19.         it  uses  the environment data that it passes.  This  means  that
  20.         PKarc and PKXarc don't have to be in the same drive or  directory
  21.         as  you are, but it has to be in the path.  It kind of has a  fit
  22.         if it isn't.  But who doesn't have their ARC programs in the path
  23.         anyway?
  24.  
  25.         Another  requirement  is that there has to be free space  on  the
  26.         current logged drive\directory.  The reason for this, is that the
  27.         program uses PKarc's V option, and I have DOS redirect the output
  28.         to  a  file called files.$$$.  This is the slowest  part  of  the
  29.         program,  and  if I knew how ARC files were structured,  I  would
  30.         bypass  the whole process altogether.  But for the moment, it  is
  31.         how  I  have to get things done.  The process  can  produce  some
  32.         quite large files sometimes (12K for 145 arc file members).  As I
  33.         haven't  put  in a check for a full disk (hoping  to  bypass  the
  34.         process later) the program won't work right if the disk fills  up
  35.         trying to create the reference file.
  36.  
  37.         Command Line Syntax:
  38.  
  39.         NOTE: Everything in brackets [] are optional parameters.
  40.  
  41.         PKXtract [drive:][\directory\]Sourcefile[.ARC] [drive:][\directory]
  42.  
  43.         Entering 'PKXtract ?' will give you this line also.
  44.  
  45.         Examples:
  46.           PKXtract F:FILENAME.ARC
  47.           PKXtract F:\FILENAME
  48.           PKXtract F:\DWN-LDS\FILENAME.ARC
  49.             Assuming the Current logged drive\directory is D:\LOGGED, the
  50.             file  FILENAME.ARC  will  be brought up  on  the  screen  and
  51.             selected  files  will  be extracted  to  the  current  logged
  52.             drive\directory (D:\LOGGED).
  53.  
  54.           PKXtract F:\FILENAME.ARC G:\TESTING
  55.           PKXtract F:FILENAME.ARC G:\TESTING\
  56.           PKXtract FILENAME.ARC G:\TESTING\
  57.             Extracted  files will be sent to G:\TESTING assuming that  it
  58.             exists.
  59.  
  60.  
  61.  
  62.                                        1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         PKXTract.EXE Version 1.0                          12 January 1988
  69.         Copyright (C) 1988                                    Chris Brown
  70.  
  71.           PKXtract F:\WHATEVER\PATHNAME\FILENAME.ARC G:
  72.             Extracted files will be sent to the current logged  directory
  73.             of  drive  G: (Not necessarily the root directory).   If  the
  74.             current directory of drive G: is \TESTING, that is where  the
  75.             files will go.
  76.  
  77.           PKXtract F:FILENAME G:\
  78.             This  will send the extracted files to the root directory  of
  79.             drive G: regardless of the current logged directory of  drive
  80.             G:.
  81.         Got the idea?
  82.  
  83.         Although  PKXtract  doesn't check if the destination  has  enough
  84.         room  on  it (future version?) PKXarc will.  Just watch  for  the
  85.         Disk  Full warning.  Also, I might write the program so  that  it
  86.         will create destination directories.  "We'll see..."
  87.  
  88.         Another check that PKXtract doesn't do is check for the length of
  89.         the  command  line  that it sends to DOS and  PKXarc.   For  that
  90.         reason,  I  have  limited the amount of files that  it  sends  to
  91.         PKXarc  to  5 at a time.  For instance, if you tag  9  files,  it
  92.         sends 5 the first time, and on the second pass it sends the  last
  93.         4.  This may seem  pretty small, but when you get source  direct-
  94.         ories of say:
  95.  
  96.         C:\BIN\NEW\OLD\TESTING\BETA\WHATEVER\I-FORGOT\FILENAME.ARC
  97.  
  98.         and destination directories of:
  99.  
  100.         A:\THIS\IS\JUST\TOO\MUCH
  101.  
  102.         and  on  the  top of that you get 5 files that can be  up  to  12
  103.         characters  apiece  (counting the space in between  file  specs),
  104.         well, you get what you deserve...
  105.  
  106.         Once inside the program, you are presented with all of the  files
  107.         and a hi-lited bar (right now the bar is red, but I might  change
  108.         that  before releasing this).
  109.  
  110.         Movement commands:
  111.  
  112.         Down Arrow:
  113.         This moves the hi-lited bar down one file name at a time.  If you
  114.         are on the last entry, it will not wrap around to the top.  I did
  115.         have it wrap around, but I didn't like it so I trapped it to  the
  116.         last file.  That might change again depending on requests.
  117.  
  118.         Up Arrow:
  119.         This moves the hi-lited bar up one file at a time.  For the  same
  120.         reasons as the down arrow, it too will not wrap if you are on the
  121.         first file.
  122.  
  123.         PgDn:
  124.         This  is a dual function key because of the lack of space on  the
  125.         screen  for the description.  First, if you are not on  the  last
  126.  
  127.  
  128.                                        2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.         PKXTract.EXE Version 1.0                          12 January 1988
  135.         Copyright (C) 1988                                    Chris Brown
  136.  
  137.         file  of the screen, pressing PgDn once will put you  there.   If
  138.         you  are  at the bottom of the screen, it will bring  up  23  new
  139.         files  (if there are 23 files left to display) and leave the  hi-
  140.         lited  bar at the bottom of the screen (even if there weren't  23
  141.         more  files  to display).  This too will not wrap around  to  the
  142.         top file.
  143.  
  144.         PgUp:
  145.         This is the same as PgDn, except it takes you toward the  Beginn- 
  146.         ing of the files instead of the end.  No wrap around here either!
  147.  
  148.         Home, End:
  149.         These will take you to the beginning or the end of the listing.
  150.  
  151.  
  152.         File Commands:
  153.  
  154.         T - Tag File:
  155.         Tags  a file for extraction.  When pressed, a solid  greater-than
  156.         sign  (>)  appears next to the file.  The tagged file  count  and
  157.         the Total Bytes Tagged count are incremented.
  158.  
  159.         U - Untag File:
  160.         Untags  a previously tagged file.  Tagged Files and  Total  Bytes
  161.         Tagged are decremented.
  162.  
  163.         Pressing the ALT key, brings up another menu:
  164.  
  165.         Alt-T - Tag all Files:
  166.         Tags  all  files for extraction.  It will also take  you  to  the
  167.         bottom of the file.  This might look like a slow process, but  if
  168.         you look at the Tagged File and Bytes Tagged count, you will  see
  169.         them  steadily increase as each file is tagged.  (If everyone  is
  170.         in that much of a hurry, I can change that).  This is the fastest
  171.         way  to  extract the files.  If none of them  get  untagged,  the
  172.         program just sends an "*.*" to PKXarc.  This bypasses the 5  file
  173.         limit that I imposed on the program, and all files are  extracted
  174.         on the first pass.
  175.  
  176.         Alt-U - Untag all Files:
  177.         Untags  all  the files, resets all of the counters to  zero,  and
  178.         puts the hi-lite bar back at the begging of the listing.
  179.  
  180.  
  181.         Alt-E - Extract Tagged Files:
  182.         Shells  out  of PKXtract, and using PKXarc, extracts all  of  the
  183.         tagged files to the destination specified, or the current  logged
  184.         drive\directory if no destination was specified.
  185.  
  186.         Alt-X - Exit to DOS:
  187.         Terminates the program, and returns to DOS.  Use this instead  of
  188.         Cntrl-Break (^C) as this will ensure that you get a cursor back.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                        3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.         PKXTract.EXE Version 1.0                          12 January 1988
  201.         Copyright (C) 1988                                    Chris Brown
  202.  
  203.         This program was written in Turbo Pascal version 4.
  204.  
  205.         If  you  find this program of use, and find your  self  using  it
  206.         regularly, and would like to see enhancements made to it (I  have
  207.         quite  a  few in mind), it would be greatly  appreciated  if  you
  208.         would pay for it.  I am only asking $10 for it, and for the  time
  209.         and  hastle  it  saves, I think that it is more  than  worth  it.
  210.         Besides,  it gives me the incentive to keep on  writing  programs
  211.         (for the public).  By sending a disk and a mailer, you will  also
  212.         receive the latest version of the program.
  213.  
  214.         Send $10 to:
  215.           Chris Brown
  216.           427 14th St.
  217.           Edwards AFB, CA  93523-5000
  218.  
  219.         Comments, bug reports and suggestions are more than welcome.
  220.  
  221.         I can be reached by leaving mail on GEine also.  My GEnie address
  222.         is: MAFMPD. (Don't ask me what it means!)
  223.  
  224.         Remember, only you can make Shareware Work!  Please, support it.
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                        4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.